Skip to content

Обновить услугу

Request

Частично обновляет услугу по ее идентификатору.

При изменении is_fix_price в любую сторону ожидающие предложения новой записи этой услуги (CREATE_RECORD со статусом WAITING_APPROVE) автоматически переходят в EXPIRED в той же транзакции. Чат обновляет статус и отправляет /user/queue/chat.update_status_request со значением EXPIRED участникам диалога. Для записи на новых условиях требуется новое предложение. Изменение цены без смены типа не отменяет предложения автоматически. Уже принятые предложения WAITING_FOR_PAYMENT и созданные записи сохраняются.

Для роли SALON проверка доступа к услуге выполняется через владельца салона: backend находит салон текущего пользователя, получает id владельца салона и проверяет, что услуга принадлежит этому owner id. Файлы из images по-прежнему проверяются по текущему пользователю, который отправил запрос. Для салонной услуги master_user_ids содержит users.id мастеров, которые должны оказывать услугу после изменения. Переданный список полностью заменяет текущие привязки в той же транзакции: [] снимает всех мастеров, отсутствие поля сохраняет их. Для индивидуального мастера передавать master_user_ids нельзя. Администратору салона требуется SERVICE_MANAGE.

Правила валидации:

  • хотя бы одно поле должно быть заполнено корректно
  • name, если передан, не должен быть пустым и не должен быть длиннее 120 символов
  • price должен быть в диапазоне от 1 до 100000
  • discount_percent меняет скидку услуги: null удаляет скидку (в ответе тоже null), 0 сохраняется как 0 и означает отсутствие скидки, значения 1..100 устанавливают скидку, отсутствие поля не меняет текущую скидку
  • при итоговом is_fix_price=false поле price_intervals запрещено, включая пустой массив; скидка discount_percent разрешена
  • переключение is_fix_price на false удаляет сохранённые интервалы цены и сохраняет скидку
  • duration должен быть в диапазоне от 1 до 1440 минут
  • description, если передан, не должен быть пустым и не должен быть длиннее 4000 символов
  • category_id, если передан, должен быть положительным ID существующей конечной подкатегории
  • корневую категорию или категорию с дочерними категориями нельзя назначить услуге
  • если передан images, он должен содержать от 1 до 10 уникальных положительных ID файлов в порядке клиента
  • если передан images, все файлы должны иметь purpose CARD
  • для услуги индивидуального мастера service_locations, если передан, должен содержать от 1 до 3 объектов с уникальными service_location: IN_SALON, AT_MASTER_PLACE, CLIENT_PLACE
  • для услуги индивидуального мастера проверяются итоговые места оказания: переданные в запросе либо уже сохранённые в услуге
  • в каждом переданном объекте service_locations обязателен непустой address
  • в каждом переданном объекте обязательна полная geolocation с lat и lon; координаты сохраняются напрямую без повторного геокодирования
  • для IN_SALON обязателен непустой salon_name
  • для CLIENT_PLACE обязателен radius_km со значением 1, 5, 10 или 20
  • у салонной услуги нельзя изменять service_locations, address и geolocation; она использует адрес и координаты самого салона, а передача любого из этих полей приводит к 400 invalid_body
  • master_user_ids, если передан, содержит уникальные положительные users.id мастеров того же салона; допустим любой статус мастера, включая PENDING_DELETE

Доступ:

  • требуется JWT
  • мастер должен иметь доступ к услуге как ее владелец
  • владелец или админ салона должен иметь доступ к услуге через owner id салона
  • если передан images, все файлы должны быть доступны пользователю

Готовность прикрепляемых файлов: Все переданные images должны иметь purpose CARD и статус UPLOADED. PENDING и FAILED не принимаются при прикреплении новых файлов. Проверки доступа, владельца и прочие ограничения операции сохраняются. Перед отправкой дождитесь успешного ответа POST /api/file/upload.

Security
bearerAuth or jwtCookie
Path
service_idinteger, (int64), >= 1required

Идентификатор услуги

Bodyapplication/jsonrequired

Для салонной услуги master_user_ids заменяет весь набор назначенных мастеров; [] удаляет все привязки.

namestring or null, [ 1 .. 120 ] characters.*\S.*
priceinteger or null, (int32), [ 1 .. 100000 ]

Базовая цена по умолчанию. Используется, если price_intervals отсутствуют или проверяемое время не попадает ни в один интервал.

price_intervalsArray of objects or null(ServicePriceInterval)

Только для услуг с итоговым is_fix_price=true. Если поле не передано, текущие интервалы не изменяются. Пустой массив удаляет все интервалы. При итоговом is_fix_price=false поле запрещено, включая пустой массив; ответ 400 invalid_body.

discount_percentinteger or null, (int32), [ 0 .. 100 ]

Процент скидки услуги.

Используется в PATCH /api/service/{serviceId} как обычное поле обновления услуги. Отдельного endpoint для установки скидки нет.

Правила:

  • null удаляет скидку; в ответе discount_percent будет null
  • 0 сохраняется как 0 и означает, что скидка снята
  • 1..100 устанавливает скидку в процентах
  • если поле не передано, текущая скидка не меняется
  • значения меньше 0 и значения больше 100 не являются валидной скидкой
  • скидку можно менять как для фиксированной цены, так и для цены «от» (is_fix_price=false)
durationinteger or null, (int32), [ 1 .. 1440 ]
descriptionstring or null, [ 1 .. 4000 ] characters.*\S.*
category_idinteger or null, (int64), >= 1
is_fix_priceboolean or null

При переключении на false сохранённые price_intervals удаляются, а скидка сохраняется. При итоговом is_fix_price=false поле price_intervals запрещено; discount_percent разрешено.

imagesArray of integers or null, [ 1 .. 10 ] items, unique

Ordered service image IDs. The first image is used as preview. All files must have purpose CARD.

addressstring or null, [ 1 .. 1000 ] characters

Для индивидуального мастера при передаче этого поля обязательна geolocation; адрес каждого места задаётся в service_locations.

geolocationobject or null(ProfileGeolocation)

Для индивидуального мастера обязательна при передаче верхнего address.

service_locationsArray of objects or null, [ 1 .. 3 ] items, unique(ServiceLocationRequest)

Места оказания индивидуальной услуги. Каждый элемент содержит собственный адрес и обязательные координаты. Для салонной услуги поле запрещено.

advantagesArray of strings or null, <= 5 items
seo_queriesArray of strings or null, <= 10 items, unique

Необязательные фразы для поиска. Отсутствие поля не меняет список; пустой массив очищает его.

master_user_idsArray of integers, unique

Только для услуги салона. Массив users.id мастеров этого же салона с любым статусом, включая PENDING_DELETE. Заменяет весь список привязок в той же транзакции, что и остальные изменения. Отсутствие поля сохраняет прежние привязки; пустой массив удаляет их. Для услуги индивидуального мастера поле запрещено.

Example:
[ 22, 23 ]
curl -i -X PATCH \
  'https://felmee.com/api/service/{service_id}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Мужская стрижка премиум",
    "price": 1800,
    "master_user_ids": [
      22,
      23
    ]
  }'

Responses

Услуга успешно обработана

Bodyapplication/json
codeErrorstring or nullrequired

Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.

successbooleanrequired

Флаг успешного выполнения запроса

messagestringrequired

Человекочитаемое описание результата

error_codestring or null(ERROR_CODE)required

Код ошибки. Для успешных ответов всегда null.

Enum:"INVALID_BODY""INVALID_DATE""invalid_body""unauthorized""not_found""slot_unavailable""conflict""BUSINESS_INACTIVE""INSUFFICIENT_FUNDS""REQUISITES_REQUIRED"
dataobject or null(ServiceUpdateData)required

Полезная нагрузка. Может быть объектом, массивом или null.

Response
{ "success": true, "message": "Service updated successfully", "codeError": null, "error_code": null, "data": { "changed": true, "service": { … } } }